home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / libblas / syr2k.z / syr2k
Encoding:
Text File  |  2002-10-03  |  7.0 KB  |  170 lines
  1. SYR2K(3F)                                             Last changed: 11-2-98
  2.  
  3.  
  4. NNAAMMEE
  5.      SSSSYYRR22KK, DDSSYYRR22KK, CCSSYYRR22KK, ZZSSYYRR22KK - Performs symmetric rank 2_k update of
  6.      a real or complex symmetric matrix
  7.  
  8. SSYYNNOOPPSSIISS
  9.      Real
  10.  
  11.         CCAALLLL SSSSYYRR22KK ((_u_p_l_o,, _t_r_a_n_s,, _n,, _k,, _a_l_p_h_a,, _a,, _l_d_a,, _b,, _l_d_b,, _b_e_t_a,, _c,,
  12.         _l_d_c))
  13.  
  14.      Double precision
  15.  
  16.         CCAALLLL DDSSYYRR22KK ((_u_p_l_o,, _t_r_a_n_s,, _n,, _k,, _a_l_p_h_a,, _a,, _l_d_a,, _b,, _l_d_b,, _b_e_t_a,, _c,,
  17.         _l_d_c))
  18.  
  19.      Complex
  20.  
  21.         CCAALLLL CCSSYYRR22KK ((_u_p_l_o,, _t_r_a_n_s,, _n,, _k,, _a_l_p_h_a,, _a,, _l_d_a,, _b,, _l_d_b,, _b_e_t_a,, _c,,
  22.         _l_d_c))
  23.  
  24.      Double complex
  25.  
  26.         CCAALLLL ZZSSYYRR22KK ((_u_p_l_o,, _t_r_a_n_s,, _n,, _k,, _a_l_p_h_a,, _a,, _l_d_a,, _b,, _l_d_b,, _b_e_t_a,, _c,,
  27.         _l_d_c))
  28.  
  29. IIMMPPLLEEMMEENNTTAATTIIOONN
  30.      IRIX systems
  31.  
  32. DDEESSCCRRIIPPTTIIOONN
  33.      SSSSYYRR22KK and DDSSYYRR22KK performs a symmetric rank 2_k update of a real
  34.      symmetric matrix.
  35.  
  36.      CCSSYYRR22KK and ZZSSYYRR22KK performs a symmetric rank 2_k update of a complex
  37.      symmetric matrix.
  38.  
  39.      These routines perform one of the following symmetric rank 2_k
  40.      operations:
  41.                        T           T
  42.           C <- alpha AB  + alpha BA  + beta C
  43.  
  44.           or
  45.                       T           T
  46.           C <- alpha A B + alpha B A + beta C
  47.  
  48.      where
  49.  
  50.      * _a_l_p_h_a and _b_e_t_a are scalars
  51.  
  52.      * _C is an _n-by-_n symmetric matrix
  53.  
  54.      * _A and _B are _n-by-_k matrices in the first operation listed previously
  55.        and _k-by-_n matrices in the second
  56.         _T      _T
  57.      * _A  and _B  are transposes of _A and _B, respectively
  58.  
  59.      These routines have the following arguments:
  60.  
  61.      _u_p_l_o      Character*1.  (input)
  62.                Specifies whether the upper or lower triangular part of
  63.                array _c is referenced, as follows:
  64.  
  65.                _u_p_l_o = 'U' or 'u': only the upper triangular part of _c is
  66.                referenced.
  67.                _u_p_l_o = 'L' or 'l': only the lower triangular part of _c is
  68.                referenced.
  69.  
  70.      _t_r_a_n_s     Character*1.  (input)
  71.                Specifies the operation to be performed, as follows:
  72.                                                  T           T
  73.                _t_r_a_n_s = 'N' or 'n':  C <- alpha AB  + alpha BA  + beta C
  74.                                                 T           T
  75.                _t_r_a_n_s = 'T' or 't':  C <- alpha A B + alpha B A + beta C
  76.  
  77.      _n         Integer.  (input)
  78.                Specifies the order of matrix _C.  _n must be >= 0.
  79.  
  80.      _k         Integer.  (input)
  81.  
  82.                On entry with _t_r_a_n_s = 'N' or 'n', _k specifies the number of
  83.                columns of matrices _A and _B.
  84.  
  85.                On entry with _t_r_a_n_s = 'T' or 't', _k specifies the number of
  86.                rows of matrices _A and _B.
  87.  
  88.                _k must be >= 0.
  89.  
  90.      _a_l_p_h_a     Scalar factor.  (input)
  91.                SSSSYYRR22KK: Real.
  92.                DDSSYYRR22KK: Double precision.
  93.                CCSSYYRR22KK: Complex.
  94.                ZZSSYYRR22KK: Double complex.
  95.  
  96.      _a         Array of dimension (_l_d_a,_k_a).  (input)
  97.                SSSSYYRR22KK: Real array.
  98.                DDSSYYRR22KK: Double precision array.
  99.                CCSSYYRR22KK: Complex array.
  100.                ZZSSYYRR22KK: Double complex array.
  101.                When _t_r_a_n_s = 'N' or 'n', _k_a is _k; otherwise, it is _n.
  102.                Contains the matrix _A.
  103.  
  104.                Before entry with _t_r_a_n_s = 'N' or 'n', the leading _n-by-_k
  105.                part of array _a must contain matrix _A; otherwise, the
  106.                leading _k-by-_n part of array _a must contain matrix _A.
  107.  
  108.      _l_d_a       Integer.  (input)
  109.                Specifies the first dimension of _a as declared in the
  110.                calling program.  If _t_r_a_n_s = 'N' or 'n', _l_d_a >= MMAAXX(1,_n);
  111.                otherwise, _l_d_a >= MMAAXX(1,_k).
  112.  
  113.      _b         Array of dimension (_l_d_b,_k_b).  (input)
  114.                SSSSYYRR22KK: Real array.
  115.                DDSSYYRR22KK: Double precision array.
  116.                CCSSYYRR22KK: Complex array.
  117.                ZZSSYYRR22KK:  Double complex array.
  118.  
  119.                When _t_r_a_n_s = 'N' or 'n', _k_b is _k; otherwise, it is _n.
  120.                Contains the matrix _B.
  121.  
  122.                Before entry with _t_r_a_n_s = 'N' or 'n', the leading _n-by-_k
  123.                part of array _b must contain matrix _B; otherwise, the
  124.                leading _k-by-_n part of array _b must contain matrix _B.
  125.  
  126.      _l_d_b       Integer.  (input)
  127.                Specifies the first dimension of _b as declared in the
  128.                calling program.  If _t_r_a_n_s = 'N' or 'n', _l_d_b >= MMAAXX(1,_n);
  129.                otherwise, _l_d_b >= MMAAXX(1,_k).
  130.  
  131.      _b_e_t_a      Scalar factor.  (input)
  132.                SSSSYYRR22KK: Real.
  133.                DDSSYYRR22KK: Double precision.
  134.                CCSSYYRR22KK: Complex.
  135.                ZZSSYYRR22KK: Double complex.
  136.  
  137.      _c         Array of dimension (_l_d_c,_n).  (input and output)
  138.                SSSSYYRR22KK: Real array.
  139.                DDSSYYRR22KK: Double precision array.
  140.                CCSSYYRR22KK: Complex array.
  141.                ZZSSYYRR22KK: Double complex array.
  142.                Contains the matrix _C.
  143.  
  144.                Before entry with _u_p_l_o = 'U' or 'u', the leading _n-by-_n
  145.                upper triangular part of array _c must contain the upper
  146.                triangular part of the symmetric matrix.  The strictly lower
  147.                triangular part of _c is not referenced.  On exit, the upper
  148.                triangular part of the updated matrix overwrites the upper
  149.                triangular part of array _c.
  150.  
  151.                Before entry with _u_p_l_o = 'L' or 'l', the leading _n-by-_n
  152.                lower triangular part of array _c must contain the lower
  153.                triangular part of the symmetric matrix.  The strictly upper
  154.                triangular part of _c is not referenced.  On exit, the lower
  155.                triangular part of the updated matrix overwrites the lower
  156.                triangular part of array _c.
  157.  
  158.      _l_d_c       Integer.  (input)
  159.                Specifies the first dimension of _c as declared in the
  160.                calling program.  _l_d_c >= MMAAXX(1,_n).
  161.  
  162. NNOOTTEESS
  163.      These routines are Level 3 Basic Linear Algebra Subprograms (Level 3
  164.      BLAS).
  165.  
  166. SSEEEE AALLSSOO
  167.      HHEERR22KK(3F)
  168.  
  169.      This man page is available only online.
  170.